home *** CD-ROM | disk | FTP | other *** search
/ Business Shareware / Business Shareware.iso / start / gfxapps / pbmpl91d / pbmplus / man / pnmtops.man < prev    next >
Text File  |  1993-01-08  |  3KB  |  136 lines
  1.  
  2.  
  3. pnmtops(1)                 Unix Programmer's Manual                 pnmtops(1)
  4.  
  5.  
  6. NAME
  7.      pnmtops - convert portable anymap to PostScript
  8.  
  9. SYNOPSIS
  10.      pnmtops [-scale s] [-turn|-noturn] [-rle|-runlength] [-dpi n] [-width  n]
  11.                      -                                          -           -
  12.      [-height n] [pnmfile]
  13.               -   -------
  14.  
  15. DESCRIPTION
  16.      Reads a portable anymap as input.  Produces  Encapsulated  PostScript  as
  17.      output.
  18.  
  19.      If the input file is  in  color  (PPM),  a  color  PostScript  file  gets
  20.      written.  Some PostScript interpreters can't handle color PostScript.  If
  21.      you have one of these you will need to run your  image  through  ppmtopgm
  22.                                                                       --------
  23.      first.
  24.  
  25.      Note that there is no pstopnm tool  -  this  transformation  is  one-way,
  26.      because  a  pstopnm  tool would be a full-fledged PostScript interpreter,
  27.      which is beyond the scope of this package.  However,  see  the  psidtopgm
  28.                                                                      ---------
  29.      tool,  which  can  read  grayscale  non-runlength  PostScript image data.
  30.      Also, if you're willing to install the fairly large GhostScript  package,
  31.      it comes with a pstoppm script.
  32.  
  33. OPTIONS
  34.  
  35.      The -scale flag controls the scale of the result.  The default  scale  is
  36.      1,  which  on  a  300 dpi printer such as the Apple LaserWriter makes the
  37.      output look about the same size as the input would if it was displayed on
  38.      a typical 72 dpi screen.  To get one PNM pixel per 300 dpi printer pixel,
  39.      use "-scale 0.25".
  40.  
  41.      The -turn and -noturn flags control whether  the  image  gets  turned  90
  42.      degrees.   Normally, if an image is wider than it is tall, it gets turned
  43.      automatically to better fit the page.  If the -turn flag is specified, it
  44.      will  be  turned  no  matter  what  its shape; and if the -noturn flag is
  45.      specified, it will not be turned no matter what its shape.
  46.                         ---
  47.  
  48.      The -rle or -runlength flag specifies run-length compression.   This  may
  49.      save time if the host-to-printer link is slow; but normally the printer's
  50.      processing time dominates, so -rle makes things slower.
  51.  
  52.      The -dpi flag lets you specify the dots per inch of your  output  device.
  53.      The  default  is 300 dpi.  In theory PostScript is device-independent and
  54.      you don't have to worry about this, but in practice its raster  rendering
  55.      can have unsightly bands if the device pixels and the image pixels aren't
  56.      in sync.
  57.  
  58.      The -width and -height flags let you specify the size of the  page.   The
  59.      default is 8.5 inches by 11 inches.
  60.  
  61.      All flags can be abbreviated to their shortest unique prefix.
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                                26 October 1991                               1
  70.  
  71.  
  72.  
  73. pnmtops(1)                 Unix Programmer's Manual                 pnmtops(1)
  74.  
  75.  
  76. SEE ALSO
  77.      pnm(5), psidtopgm(1)
  78.  
  79. AUTHOR
  80.      Copyright (C) 1989, 1991 by Jef Poskanzer.
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.                                26 October 1991                               2
  135.  
  136.